home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2007 September / PCWSEP07.iso / Software / Linux / Linux Mint 3.0 Light / LinuxMint-3.0-Light.iso / casper / filesystem.squashfs / usr / include / libpurple / dnssrv.h < prev    next >
Encoding:
C/C++ Source or Header  |  2007-05-04  |  1.8 KB  |  65 lines
  1. /**
  2.  * @file dnssrv.h
  3.  *
  4.  * purple
  5.  *
  6.  * Copyright (C) 2005, Thomas Butter <butter@uni-mannheim.de>
  7.  *i
  8.  * This program is free software; you can redistribute it and/or modify
  9.  * it under the terms of the GNU General Public License as published by
  10.  * the Free Software Foundation; either version 2 of the License, or
  11.  * (at your option) any later version.
  12.  *
  13.  * This program is distributed in the hope that it will be useful,
  14.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16.  * GNU General Public License for more details.
  17.  *
  18.  * You should have received a copy of the GNU General Public License
  19.  * along with this program; if not, write to the Free Software
  20.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21.  */
  22.  
  23. #ifndef _PURPLE_DNSSRV_H
  24. #define _PURPLE_DNSSRV_H
  25.  
  26. #ifdef __cplusplus
  27. extern "C" {
  28. #endif
  29.  
  30. typedef struct _PurpleSrvResponse PurpleSrvResponse;
  31. typedef struct _PurpleSrvQueryData PurpleSrvQueryData;
  32.  
  33. struct _PurpleSrvResponse {
  34.     char hostname[256];
  35.     int port;
  36.     int weight;
  37.     int pref;
  38. };
  39.  
  40. typedef void (*PurpleSrvCallback)(PurpleSrvResponse *resp, int results, gpointer data);
  41.  
  42. /**
  43.  * Queries an SRV record.
  44.  *
  45.  * @param protocol Name of the protocol (e.g. "sip")
  46.  * @param transport Name of the transport ("tcp" or "udp")
  47.  * @param domain Domain name to query (e.g. "blubb.com")
  48.  * @param cb A callback which will be called with the results
  49.  * @param extradata Extra data to be passed to the callback
  50.  */
  51. PurpleSrvQueryData *purple_srv_resolve(const char *protocol, const char *transport, const char *domain, PurpleSrvCallback cb, gpointer extradata);
  52.  
  53. /**
  54.  * Cancel an SRV DNS query.
  55.  *
  56.  * @param query_data The request to cancel.
  57.  */
  58. void purple_srv_cancel(PurpleSrvQueryData *query_data);
  59.  
  60. #ifdef __cplusplus
  61. }
  62. #endif
  63.  
  64. #endif /* _PURPLE_DNSSRV_H */
  65.